OVERVIEW OF FAXING AND USING FAXPAK LIBRARY FOR CLIPPER
-----------------------------------------------------------------------------
FAXPak Library for Clipper allows your Clipper program to fax using a CAS
compatible fax board. It also allows retrieving the status of faxes you send.

 FPCLIP works ONLY with Clipper 5! 

In order to get the most use from this product, I highly recommend that
you obtain the CAS documentation from Intel. This covers all aspects of
using a CAS fax board from within applications. You can get this from
Intel's BBS, from Compuserve, or from the FAXPak BBS (303.772.6778).
-----------------------------------------------------------------------------
OVERVIEW OF FAXING

Since the most popular CAS compatible fax boards are the Intel boards
(SatisFAXtion and Connection Coprocessor), this discussion assumes that
your are using one of them. If you are using a different CAS board, you
will need to verify that it works like the Intel boards.
-----------------------------------------------------------------------------
TYPES OF FILES THAT CAN BE FAXED

The Intel fax boards understand three types of files directly: plain TEXT
files, PCX images, and DCX images. A plain text file may contain any of
the IBM characters including the "high ASCII" line drawing and special
symbols. NOTE: The Intel Net SatisFAXtion product understands and
can fax TWO additional file types: HP PCL IV files and Epson FX85 files.

PCX files are bit image files that are quite common in the PC world. There
are certain requirements for PCX files in order to faxed properly. They
MUST be black and white, they must be 200x200 bits per inch, they can't
be any wider than a normal 8.5 inch page, etc. Please see your fax board
documentation for full limitations.

DCX files are a special form of PCX file. They consist of a header that
contains the file location for each page in the document. Each page is
actually a PCX file. Intel fax boards turn received faxes into DCX files
as they are received.

The FAXPak Clipper Library uses a file's extension to determine the type
of file you are trying to send:

    .PCX       is used to identify a PCX file
    .DCX       identifies a DCX file
    .PCL       identifies an HP PCL IV file    (Net SatisFAXtion ONLY!)
    .FX        identifies an Epson FX85 file   (Net SatisFAXtion ONLY)
    .???       Any other file extension is considered to be a plain TEXT
               file.
-----------------------------------------------------------------------------
USING FAXPAK LIBRARY FOR CLIPPER

Simply include FPCLIP.LIB in your linker script.

Since there are only three functions in this library, it should be rela-
tively easy to choose the one(s) you need.

FPINIT() must be called before using any other functions.
-----------------------------------------------------------------------------
EVERYTHING YOU WANTED TO NOW ABOUX FAX...but didn't know to ask!

This section provides a look at the relationship between FPCLIP and the
CAS Manager software and how the faxing process occurs.

This information is specific to the Intel SatisFAXtion board, but other
boards will have a similar setup.

There is a piece of software provided with the fax board called CASMGR.EXE.
This normally will be loaded in your AUTOEXEC.BAT. This is Intel's
CAS Manager and it provides a way for programs to "talk" to the fax
board via the Communicating Application Specification (CAS).

In CAS jargon, an "event" is a fax send or receive. The CAS Manager
manipulates events in queues. There are three queues of events: the
pending (or TASK) queue, the RECEIVE queue, and the LOG queue.

When you send a fax with FPCLIP here's what really happens:

1. You specify the fax info (name, phone, etc) and FPCLIP writes this
   info to a file in a specific format (called a CAS CONTROL FILE).

2. FPCLIP passes the name of this control file to the CAS Manager where
   it is examined for any errors or bad structure.

3. If there are no errors, CAS Manager assigns a unique "event id" number
   to that event, passes the event ID back to FPCLIP, then puts that
   particular event into the TASK (pending) queue.

4. When the time comes for that event to be faxed (perhaps later at
   night when rates are low), CAS Manager removes the event from the
   TASK queue and makes it the "current event". It then attempts to
   complete the fax.

5. If the fax completes, CAS Manager moves the fax from the "current
   event" to the LOG queue and assigns it a completion code of 0.

6. If the fax fails to complete, CAS Manager may perform a retry of the
   fax depending on the fax board installation parameters. If no retries
   are to be performed or if all retries have been performed, then CAS
   manager moves the event to the LOG queue and assigns it a NEGATIVE
   completion code to indicate that the fax was not successful.

Intel's SatisFAXtion board has a limit of 101 log entries that it will
allow in the LOG queue. When the 102nd log entry is moved in to the
LOG queue by CAS Manager, the FIRST log entry is removed from the LOG
queue. If this happens, then FPCLIP will be unable to determine the
status of the event.